本接口从基础库版本 1.9.6 起支持在小程序插件中使用
将本地资源上传到服务器。客户端发起一个 HTTPS POST 请求,其中 content-type 为 multipart/form-data。使用前请注意阅读相关说明。
参数Object object属性类型默认值必填说明最低版本urlstring是开发者服务器地址filePathstring是要上传文件资源的路径 (本地路径)namestring是文件对应的 key,开发者在服务端可以通过这个 key 获取文件的二进制内容headerObject否HTTP 请求 Header,Header 中不能设置 RefererformDataObject否HTTP 请求中其他额外的 form datatimeoutnumber否超时时间,单位为毫秒2.10.0successfunction否接口调用成功的回调函数failfunction否接口调用失败的回调函数completefunction否接口调用结束的回调函数(调用成功、失败都会执行)object.success 回调函数参数Object res属性类型说明datastring开发者服务器返回的数据statusCodenumber开发者服务器返回的 HTTP 状态码返回值UploadTask基础库 1.4.0 开始支持,低版本需做兼容处理。
一个可以监听上传进度进度变化的事件和取消上传的对象
示例代码wx.chooseImage({ success (res) {const tempFilePaths = res.tempFilePathswx.uploadFile({ url: 'https://example.weixin.qq.com/upload', //仅为示例,非真实的接口地址 filePath: tempFilePaths[0], name: 'file', formData: {'user': 'test' }, success (res){const data = res.data//do something }}) }})